home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / xdsn217.zip / DOC / problems.txt < prev    next >
Text File  |  1996-07-10  |  3KB  |  89 lines
  1. PROBLEMS.TXT                   Copyright (c) 1991-1996 xTech Ltd
  2. ----------------------------------------------------------------
  3.  
  4.                  Native XDS-x86 OS/2 Edition
  5.                  ---------------------------
  6.                      v2.17 (pre-release)
  7.  
  8.                         Known Problems
  9.  
  10.  
  11. Optlink calling convention
  12. --------------------------
  13.  
  14. Take into account that XDS compiler does not yet support the Optlink
  15. calling convention used by IBM C Set++ and Visual Age C++ compilers,  
  16. and,  much worse,  in the standard C libraries,  suppiled with these 
  17. compilers.  So  you  can not call any functions from these libraries
  18. (or other C modules  compiled  by  IBM compilers) directly from your
  19. Modula-2 or Oberon-2 code.  In order to call an _Optlink C function, 
  20. you have to write a wrapper C function with _SysCall conventions.
  21.  
  22.  
  23. PIM to ISO Modula-2 Porting
  24. ---------------------------
  25.  
  26. XDS requires the use of "FORWARD" procedures declarations when
  27. necessary. This "declare-before-use" approach is perfectly valid
  28. for ISO-conformant compilers.
  29.  
  30. There is a lot of Modula-2 dialects, most of which are based on PIM.
  31. XDS Modula-2 in the default mode (when the M2EXTENSIONS option is
  32. turned off) is 100% ISO compliant.
  33.  
  34. The following is a compact list of language features introduced in
  35. ISO Modula-2 which do not exist in PIM. Refer to the User's Guide
  36. (XDS Modula-2 | New language features section) for details.
  37.  
  38.   - New keywords and pervasive identifiers
  39.   - Syntax for source code directives
  40.   - Complex types COMPLEX and LONGCOMPLEX
  41.   - PACKEDSET types
  42.   - String concatenation
  43.   - Value constructors
  44.   - Multi-dimensional open arrays
  45.   - Procedure constants
  46.   - Additional whole number division operators
  47.   - INT and LFLOAT type conversion functions
  48.   - Module finalization
  49.   - Exception handling
  50.   - Termination
  51.   - Coroutines and interrupt handling
  52.   - Module protection
  53.   - The module SYSTEM significantly changed
  54.   - New system modules added: EXCEPTIONS, M2EXCEPTION,
  55.     TERMINATION, COROUTINES
  56.  
  57. Language features which do not exist in ISO Modula-2:
  58.  
  59.   - EXPORT and EXPORT QUALIFIED statements in definition modules.
  60.   - Type casting using TypeName(Expression). Use SYSTEM.CAST instead.
  61.     Note: XDS supports old style type casting as an extension.
  62.  
  63.  
  64. Bug reporting
  65. -------------
  66.  
  67. If you suspect that you found a bug in XDS:
  68.  
  69.     1. Ensure that you have the latest version of XDS.
  70.     2. Ensure that ALL your sources had been recompiled by the
  71.        latest version of XDS.
  72.  
  73. If you are still sure that it is an XDS bug, please report it to us.
  74. We are grateful indeed for bug reports.
  75.  
  76. Please provide the following information:
  77.  
  78.     - version number of XDS you use
  79.     - platform details (CPU, FPU, and operating system)
  80.     - XDS compiler options
  81.  
  82. along with a minimal piece of source code causing error.
  83.  
  84. Please send bug reports to:
  85.  
  86.     xds@iis.nsk.su.
  87.  
  88.                         [end of document]
  89.